home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / strtod.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  51 lines
  1.  
  2. STRTOD(3)                  UNIX Programmer's Manual                  STRTOD(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttoodd - convert ASCII string to double
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddlliibb..hh>>
  9.  
  10.      _d_o_u_b_l_e
  11.      ssttrrttoodd(_c_o_n_s_t _c_h_a_r _*_n_p_t_r, _c_h_a_r _*_*_e_n_d_p_t_r)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ssttrrttoodd() function converts the initial portion of the string pointed
  15.      to by _n_p_t_r to _d_o_u_b_l_e representation.
  16.  
  17.      The expected form of the string is an optional plus (``+'') or minus sign
  18.      (``-'') followed by a sequence of digits optionally containing a decimal-
  19.      point character, optionally followed by an exponent.  An exponent con-
  20.      sists of an ``E'' or ``e'', followed by an optional plus or minus sign,
  21.      followed by a sequence of digits.
  22.  
  23.      Leading white-space characters in the string (as defined by the iss-
  24.      pace(3) function) are skipped.
  25.  
  26. RREETTUURRNN VVAALLUUEESS
  27.      The ssttrrttoodd() function returns the converted value, if any.
  28.  
  29.      If _e_n_d_p_t_r is not NULL, a pointer to the character after the last charac-
  30.      ter used in the conversion is stored in the location referenced by
  31.      _e_n_d_p_t_r.
  32.  
  33.      If no conversion is performed, zero is returned and the value of _n_p_t_r is
  34.      stored in the location referenced by _e_n_d_p_t_r.
  35.  
  36.      If the correct value would cause overflow, plus or minus HUGE_VAL is re-
  37.      turned (according to the sign of the value), and ERANGE is stored in
  38.      _e_r_r_n_o. If the correct value would cause underflow, zero is returned and
  39.      ERANGE is stored in _e_r_r_n_o.
  40.  
  41. EERRRROORRSS
  42.      [ERANGE]      Overflow or underflow occurred.
  43.  
  44. SSEEEE AALLSSOO
  45.      atof(3),  atoi(3),  atol(3),  strtol(3),  strtoul(3)
  46.  
  47. SSTTAANNDDAARRDDSS
  48.      The ssttrrttoodd() function conforms to ANSI C3.159-1989 (``ANSI C'').
  49.  
  50. BSD Experimental                 June 29, 1991                               1
  51.